package com.atguigu.schedule.mapper;

import com.atguigu.schedule.pojo.SlamSession;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * SLAM会话Mapper接口
 * 
 * @author atguigu
 * @since 2024
 */
@Mapper
public interface SlamSessionMapper {
    
    /**
     * 插入会话
     * 
     * @param slamSession 会话信息
     * @return 影响行数
     */
    int insert(SlamSession slamSession);
    
    /**
     * 根据ID查询会话
     * 
     * @param id 会话ID
     * @return 会话信息
     */
    SlamSession selectById(@Param("id") Long id);
    
    /**
     * 根据会话名称查询
     * 
     * @param sessionName 会话名称
     * @return 会话信息
     */
    SlamSession selectBySessionName(@Param("sessionName") String sessionName);
    
    /**
     * 根据状态查询会话列表
     * 
     * @param status 状态
     * @return 会话列表
     */
    List<SlamSession> selectByStatus(@Param("status") SlamSession.SessionStatus status);
    
    /**
     * 根据地图ID查询会话
     * 
     * @param mapId 地图ID
     * @return 会话列表
     */
    List<SlamSession> selectByMapId(@Param("mapId") Long mapId);
    
    /**
     * 查询活跃的会话
     * 
     * @return 活跃会话列表
     */
    List<SlamSession> selectActiveSessions();
    
    /**
     * 查询最近的会话
     * 
     * @return 最近会话列表
     */
    List<SlamSession> selectRecentSessions();
    
    /**
     * 根据状态和时间范围查询
     * 
     * @param status 状态
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 会话列表
     */
    List<SlamSession> selectByStatusAndTimeRange(@Param("status") SlamSession.SessionStatus status, 
                                                @Param("startTime") LocalDateTime startTime, 
                                                @Param("endTime") LocalDateTime endTime);
    
    /**
     * 统计各状态的会话数量
     * 
     * @return 统计结果
     */
    List<Object[]> countByStatus();
    
    /**
     * 更新会话信息
     * 
     * @param slamSession 会话信息
     * @return 影响行数
     */
    int update(SlamSession slamSession);
    
    /**
     * 删除会话
     * 
     * @param id 会话ID
     * @return 影响行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 查询所有会话
     * 
     * @return 会话列表
     */
    List<SlamSession> selectAll();
}
